Screen Wake Lock API: Veb-ilovalarda ekranning o‘chib qolishini oldini olish

Screen Wake Lock API — bu veb-ilovalarga qurilmalarning ekranini xiralashtirish yoki qulflashning oldini olish imkonini beruvchi veb-API. Bu, ayniqsa, mediapleyerlar, navigatsiya ilovalari va uzoq vaqt davomida foydalanuvchi bilan o'zaro aloqani talab qiladigan ilovalar kabi doimiy ekran ko'rinishi muhim bo'lgan ilovalar uchun foydalidir.

Nima uchun Screen Wake Lock muhim?

Bugungi kunda foydalanuvchilar uzluksiz tajribani kutishadi. Avtomatik ravishda ekranini xiralashtiradigan yoki qulflaydigan qurilma, ayniqsa foydalanuvchilar veb-ilova bilan faol shug‘ullanayotgan paytda, bu tajribani buzishi mumkin. Quyidagi holatlarni ko'rib chiqing:

• Video ijrosi: Kino ko‘rayotganingizni yoki pazandachilik darsligiga amal qilayotganingizni tasavvur qiling, ekran doimiy ravishda xiralashib, uni yoqib turish uchun ekranni bosishga majbur qiladi. Bu juda asabiylashtiruvchi tajriba.
• Navigatsiya ilovalari: Mashina haydayotganda va navigatsiya ilovasidan foydalanayotganda, doimiy yo‘nalishlarni ko'rsatish uchun ekran yoqilgan holda qolishi kerak. Xiralashgan yoki qulflangan ekran burilishlarni o‘tkazib yuborishga va potentsial xavfsizlik xavfiga olib kelishi mumkin.
• Taqdimot ilovalari: Slaydlarni taqdim etish yoki muhim ma'lumotlarni ko'rsatish taqdimot davomida ekranning faol bo'lishini talab qiladi.
• O‘yin ilovalari: Ko'pgina o'yinlar o'yin jarayoni uchun uzluksiz ekran ko'rinishini talab qiladi. Ekran uyqusi o'yin tajribasini buzishi mumkin.
• Onlayn doskalar: Onlayn doskada birgalikda ishlash, foydalanuvchilar qayta aloqa o‘rnatish uchun doimiy ravishda bosishlariga hojat qolmasligi uchun ekranning uyg'oq qolishini talab qiladi.

Screen Wake Lock API bu muammolarga yechim taklif etadi, veb-ilovalarga ekranning yoqish/o‘chirish holatini boshqarish va yanada uzluksiz hamda foydalanuvchilar uchun qulay tajribani taqdim etish imkonini beradi.

Brauzerlarda qo'llab-quvvatlanishi

2024-yil oxiriga kelib, Screen Wake Lock API asosiy brauzerlarda ishonchli qo'llab-quvvatlanadi. Biroq, optimal kross-brauzer mosligini ta'minlash uchun har doim Mozilla Developer Network (MDN) va Can I use kabi manbalardagi eng so'nggi brauzer mosligi ma'lumotlarini tekshirish juda muhim. Brauzerning qo'llab-quvvatlashi brauzer versiyasi va operatsion tizimga qarab farq qilishi mumkin.

Screen Wake Lock API'dan foydalanish

Screen Wake Lock API'dan foydalanish nisbatan oson. Quyida asosiy bosqichlar tavsifi keltirilgan:

1. API'ni qo'llab-quvvatlashni tekshirish

API'dan foydalanishga urinishdan oldin, foydalanuvchining brauzeri uni qo'llab-quvvatlashini tekshirish muhim. Bu API'ni tatbiq etmagan brauzerlarda xatolarning oldini oladi.

            if ('wakeLock' in navigator) {
  // Screen Wake Lock API qo'llab-quvvatlanadi
} else {
  // Screen Wake Lock API qo'llab-quvvatlanmaydi
  console.log('Screen Wake Lock API ushbu brauzerda qo\'llab-quvvatlanmaydi.');
}

            

              
                Copy
              
            
          

2. Wake Lock so'rovini yuborish

Wake lock so'rovini yuborish uchun navigator.wakeLock.request() metodidan foydalaning. Bu metod, agar so'rov muvaffaqiyatli bo'lsa, WakeLockSentinel obyekti bilan yakunlanadigan Promise qaytaradi. WakeLockSentinel obyekti faol wake lockni ifodalaydi.

            let wakeLock = null;

const requestWakeLock = async () => {
  try {
    wakeLock = await navigator.wakeLock.request('screen');
    console.log('Ekran wake lock faol!');

    wakeLock.addEventListener('release', () => {
      console.log('Screen Wake Lock bekor qilindi');
    });
  } catch (err) {
    console.error(`${err.name}, ${err.message}`);
  }
};

// Wake lock'ni faollashtirish uchun ushbu funksiyani chaqiring
requestWakeLock();

            

              
                Copy
              
            
          

Ushbu misolda requestWakeLock() funksiyasi ekran wake lockini olishga harakat qiladi. 'screen' argumenti biz ekranning xiralashishini yoki qulflanishini oldini olishni xohlayotganimizni bildiradi. Agar so'rov muvaffaqiyatli bo'lsa, konsolga xabar chiqariladi. Kod shuningdek, wake lock so'rovi paytida yuz berishi mumkin bo'lgan har qanday istisnolarni ushlash uchun xato ishlovchisini o'z ichiga oladi. Eng muhimi, kod "release" hodisasini tinglash uchun hodisa tinglovchisini qo'shadi, bu Wake Lock endi faol emasligini bildiradi. Bu foydalanuvchi qulfni aniq bekor qilganida yoki tizim quvvatni tejash choralari tufayli uni qaytarib olganida sodir bo'lishi mumkin.

3. Wake Lock'ni bekor qilish

Wake lock endi kerak bo'lmaganda uni bekor qilish juda muhim. Buni qilmaslik qurilma batareyasini tugatishi va foydalanuvchi tajribasiga salbiy ta'sir ko'rsatishi mumkin. Wake lock'ni bekor qilish uchun WakeLockSentinel obyektidagi release() metodini chaqiring.

            const releaseWakeLock = async () => {
  if (wakeLock) {
    await wakeLock.release();
    wakeLock = null;
    console.log('Ekran wake lock bekor qilindi!');
  }
};

// Wake lock'ni bekor qilish uchun ushbu funksiyani chaqiring
releaseWakeLock();

            

              
                Copy
              
            
          

Ushbu funksiya wake lockni xavfsiz tarzda bekor qiladi va wakeLock o'zgaruvchisini null ga o'rnatadi. Qulfni bekor qilishda xatolarga yo'l qo'ymaslik uchun wakeLock o'zgaruvchisining to'g'ri boshqarilishini ta'minlash muhim.

4. Wake Lock'ni bekor qilish hodisalarini boshqarish

Tizim turli sabablarga ko'ra, masalan, foydalanuvchining harakatsizligi yoki batareyaning kamligi tufayli wake lock'ni bekor qilishi mumkin. Bu holatlarni ohista boshqarish uchun WakeLockSentinel obyektidagi release hodisasini tinglash muhim. Bu sizga wake lockni qayta so'rash yoki boshqa tegishli choralarni ko'rish imkonini beradi.

            wakeLock.addEventListener('release', () => {
  console.log('Screen Wake Lock bekor qilindi');
  // Wake lockni qayta so'rashga harakat qiling
  // yoki boshqa tegishli choralarni ko'ring
  requestWakeLock(); // Masalan, wake lock'ni qayta so'rash
});

            

              
                Copy
              
            
          

Bu misol release hodisasini tinglash va ehtimol wake lockni qayta so'rashni ko'rsatadi. Haqiqiy amalga oshirish ilovangizning o'ziga xos talablariga bog'liq bo'ladi.

Eng yaxshi amaliyotlar va mulohazalar

Screen Wake Lock API kuchli vosita bo'lsa-da, undan mas'uliyat bilan foydalanish va quyidagi eng yaxshi amaliyotlarni hisobga olish muhim:

• Wake Lock so'rovlarini faqat zarur bo'lganda yuboring: Wake lock'larni keraksiz olishdan saqlaning, chunki ular qurilma batareyasini tugatishi mumkin. Faqatgina foydalanuvchi tajribasi uchun doimiy ekran ko'rinishi haqiqatan ham zarur bo'lganda wake lock so'rang.
• Wake Lock'larni zudlik bilan bekor qiling: Endi kerak bo'lmagan zahoti wake lock'ni bekor qiling. Bu batareya quvvatini tejashga va keraksiz sarflanishning oldini olishga yordam beradi.
• Bekor qilish hodisalarini ohista boshqaring: Tizim wake lockni kutilmaganda bekor qilishiga tayyor bo'ling. release hodisasini tinglang va wake lock'ni qayta so'rash yoki foydalanuvchini xabardor qilish kabi tegishli choralarni ko'ring.
• Foydalanuvchi boshqaruvlarini taqdim eting: Foydalanuvchilarga wake lock funksiyasini yoqish yoki o'chirish uchun boshqaruvlarni taqdim etishni o'ylab ko'ring. Bu foydalanuvchilarga o'z qurilmalarining quvvat sarfini ko'proq nazorat qilish imkonini beradi va ilova xatti-harakatlarini sozlashga imkon beradi. Masalan, mediapleyerda "Ekranni yoqiq holda saqlash" tugmasi bo'lishi mumkin.
• Batareya muddati haqida o'ylang: Batareya muddatiga ta'sirini yodda tuting. Ekranni doimiy ravishda yoqib turish, ayniqsa mobil qurilmalarda batareya muddatini sezilarli darajada qisqartirishi mumkin. Foydalanuvchilarni potentsial ta'sir haqida xabardor qiling va uni yumshatish uchun variantlarni taqdim eting.
• Foydalanuvchi ruxsati: API o'zi to'g'ridan-to'g'ri foydalanuvchi ruxsatini so'ramasa ham, foydalanuvchiga ilovaning ekranni uxlab qolishining oldini olayotganini bildirish va ularga bu xatti-harakatni o'chirishga ruxsat berish yaxshi amaliyotdir.
• Zaxira mexanizmi: API'ni qo'llab-quvvatlamaydigan brauzerlar uchun zaxira mexanizmini amalga oshirishni o'ylab ko'ring. Bu ekranning xiralashishini yoki qulflanishini oldini olish uchun vaqti-vaqti bilan ekranga soxta hodisalar yuborish uchun JavaScript'dan foydalanishni o'z ichiga olishi mumkin. Biroq, bu yondashuv Screen Wake Lock API'dan foydalanishdan ko'ra kamroq ishonchli va ko'proq resurs talab qilishi mumkinligini unutmang.
• Sinovdan o'tkazish: Screen Wake Lock API'ning kutilganidek ishlashiga ishonch hosil qilish uchun ilovangizni turli qurilmalar va brauzerlarda sinchkovlik bilan sinab ko'ring. Batareya sarfiga va foydalanuvchi tajribasiga e'tibor bering.
• Mavjudlik: Ekranni har doim yoqiq holda saqlash ba'zi foydalanuvchilar uchun muammoli bo'lishi mumkinligini unutmang. Ekran wake lock'ni o'chirish usullarini taqdim etish ilovangizni yanada qulayroq qiladi.

Haqiqiy hayotdan misollar

Quyida Screen Wake Lock API'dan turli ilovalarda qanday foydalanish mumkinligiga oid haqiqiy hayotdan misollar keltirilgan:

• Mediapleyerlar: Video striming ilovasi uzluksiz tomosha tajribasini ta'minlash uchun ijro paytida ekranning xiralashishini oldini olish uchun Screen Wake Lock API'dan foydalanishi mumkin.
• Navigatsiya ilovalari: Navigatsiya ilovasi foydalanuvchi mashina haydayotganda ekranni yoqiq holda saqlash uchun API'dan foydalanishi mumkin, bu esa yo'nalishlarning har doim ko'rinib turishini ta'minlaydi.
• Taqdimot ilovalari: Taqdimot ilovasi taqdimot paytida ekranning xiralashishini oldini olish uchun API'dan foydalanishi mumkin, bu esa tomoshabinlar slaydларни har doim ko'rishini ta'minlaydi.
• Fitnes ilovalari: Mashg'ulot seansini kuzatayotgan fitnes ilovasi foydalanuvchilar o'z qurilmalarini qulfdan chiqarmasdan tezda ko'rsatkichlarni ko'rishlari uchun ekranni yoqiq holda saqlashi mumkin.
• Retseptlar ilovalari: Retseptlar ilovasi foydalanuvchi retseptga amal qilayotganda ekranni yoqiq holda saqlash uchun API'dan foydalanishi mumkin, bu esa foydalanuvchi pishirayotganda ekranning xiralashishini oldini oladi.
• Kiosk ilovalari: Kiosk ilovalari bu xususiyatdan foyda ko'radi. Masalan, aeroportlar yoki restoranlardagi o'ziga-o'zi xizmat ko'rsatish kiosklari ekranning faol va foydalanuvchi o'zaro aloqalariga javob berishini ta'minlash uchun Screen Wake Lock API'dan foydalanishi mumkin.
• Telemeditsina ilovalari: Virtual shifokor qabullari paytida, ayniqsa kuzatuvni talab qiladigan hollarda, Screen Wake Lock API konsultatsiya davomida ekranning yoqiq qolishini ta'minlash uchun ishlatilishi mumkin.

Kod misoli: Screen Wake Lock bilan mediapleyer

Bu misol oddiy mediapleyer ilovasida Screen Wake Lock API'ni qanday amalga oshirishni ko'rsatadi.

            
<!DOCTYPE html>
<html>
<head>
  <title>Screen Wake Lock bilan mediapleyer</title>
</head>
<body>
  <video id="myVideo" width="640" height="360" controls>
    <source src="your-video.mp4" type="video/mp4">
    Sizning brauzeringiz video tegini qo'llab-quvvatlamaydi.
  </video>

  <button id="wakeLockBtn">Ekran Wake Lock'ni yoqish</button>

  <script>
    const video = document.getElementById('myVideo');
    const wakeLockBtn = document.getElementById('wakeLockBtn');
    let wakeLock = null;

    const requestWakeLock = async () => {
      try {
        wakeLock = await navigator.wakeLock.request('screen');
        console.log('Ekran wake lock faol!');
        wakeLockBtn.textContent = 'Ekran Wake Lock\'ni o\'chirish';

        wakeLock.addEventListener('release', () => {
          console.log('Screen Wake Lock bekor qilindi');
          wakeLockBtn.textContent = 'Ekran Wake Lock\'ni yoqish';
        });

      } catch (err) {
        console.error(`${err.name}, ${err.message}`);
      }
    };

    const releaseWakeLock = async () => {
      if (wakeLock) {
        await wakeLock.release();
        wakeLock = null;
        console.log('Ekran wake lock bekor qilindi!');
        wakeLockBtn.textContent = 'Ekran Wake Lock\'ni yoqish';
      }
    };

    wakeLockBtn.addEventListener('click', () => {
      if (wakeLock) {
        releaseWakeLock();
      } else {
        requestWakeLock();
      }
    });

    // Ixtiyoriy: Video ijrosi boshlanganda wake lock'ni avtomatik so'rash
    video.addEventListener('play', () => {
        if(!wakeLock){
            requestWakeLock();
        }
    });

  </script>
</body>
</html>

            

              
                Copy
              
            
          

Bu kod ekran wake lock'ni yoqish yoki o'chirish uchun tugmachaga ega oddiy mediapleyer yaratadi. Tugma bosilganda, kod yangi wake lock so'raydi yoki mavjudini bekor qiladi. Tugma matni wake lock'ning joriy holatini aks ettirish uchun yangilanadi. Bu misol, shuningdek, video ijrosi boshlanganda wake lock'ni avtomatik so'raydigan ixtiyoriy hodisa tinglovchisini o'z ichiga oladi. Eslatma: your-video.mp4 ni video faylingizning haqiqiy yo'li bilan almashtiring.

Xavfsizlik masalalari

Screen Wake Lock API xavfsizlikni hisobga olgan holda ishlab chiqilgan. Brauzerlar API'dan suiiste'mol qilishning oldini olish uchun turli xavfsizlik choralarini qo'llaydilar. Masalan, brauzerlar wake lock'ni ushlab turish mumkin bo'lgan vaqtni cheklashi yoki wake lock berishdan oldin foydalanuvchi aralashuvini talab qilishi mumkin. API'dan mas'uliyat va axloqiy me'yorlarga rioya qilgan holda foydalanayotganingizga ishonch hosil qilish uchun ushbu maqolada avvalroq bayon etilgan eng yaxshi amaliyotlarga har doim amal qiling.

Screen Wake Lock API'ga alternativlar

Screen Wake Lock API'dan oldin, dasturchilar ko'pincha ekran uyqusini oldini olish uchun "xak"lardan foydalanishardi. Bu usullar odatda ishonchsiz va tavsiya etilmaydi.

• Bo'sh Video Elementi: Sahifaga kichik, ovozsiz video elementini kiritish va uni doimiy ravishda ijro etish. Bu tizimni media ijro etilayotganiga ishontirib, uyquni oldini oladi. Bu juda ko'p resurs talab qiladi.
• Soxta AJAX so'rovlari: Qurilmani "faol" ushlab turish uchun serverga vaqti-vaqti bilan AJAX so'rovlarini yuborish. Bu yomon o'rinbosar, chunki u tarmoqni ko'p yuklaydi va ishonchsiz.

Bu usullar ishonchsizligi va ishlash hamda batareya muddatiga salbiy ta'sir ko'rsatishi mumkinligi sababli tavsiya etilmaydi. Screen Wake Lock API veb-ilovalarda ekran uyqusini oldini olish uchun tavsiya etilgan yechimdir.

Xulosa

Screen Wake Lock API uzluksiz va qiziqarli foydalanuvchi tajribalarini yaratmoqchi bo'lgan veb-dasturchilar uchun qimmatli vositadir. Qurilmalarning ekranini xiralashtirish yoki qulflashning oldini olish orqali siz ilovalaringizning uzoq muddatli harakatsizlik paytida ham ko'rinadigan va javob beradigan bo'lishini ta'minlashingiz mumkin. Qurilmaning batareyasini tugatishdan va foydalanuvchi tajribasiga salbiy ta'sir ko'rsatishdan saqlanish uchun API'dan mas'uliyat bilan foydalanishni va ushbu maqolada bayon etilgan eng yaxshi amaliyotlarga rioya qilishni unutmang. API kengroq qo'llanilishi bilan, u shubhasiz veb-dasturlash vositalari to'plamining muhim qismiga aylanadi. Veb-ilovalaringizni yuksaltirish va butun dunyodagi foydalanuvchilaringizga yanada yoqimli tajriba taqdim etish uchun Screen Wake Lock API'ning kuchini qabul qiling.